# 内置策略的查找与使用

qteasy 提供大量内置交易策略，可通过 ID 查找、获取文档并在 Operator 中直接使用。

## 查找与获取内置策略

- **qt.built_in_list()**：返回所有内置策略 ID 的列表（或传入模糊字符串进行筛选）。
- **qt.built_ins(stg_id)**：按 ID 返回策略类或实例的映射；不传参数则返回全部。
- **qt.built_in_doc(stg_id)**：返回该策略的文档字符串（说明、参数等）。
- **qt.get_strategy_by_id(stg_id)**：根据 ID 获取可用的策略实例，用于 ``add_strategy``。

```python
import qteasy as qt

# 列出所有内置策略 ID
ids = qt.built_in_list()
print(ids[:10])

# 获取单个策略文档
print(qt.built_in_doc('dma'))

# 获取策略实例并加入 Operator
stg = qt.get_strategy_by_id('macd')
op = qt.Operator(strategies=stg, signal_type='PT', run_freq='d')
# 或直接传 ID
op = qt.Operator(strategies='macd', signal_type='PT', run_freq='d')
```

## 在 Operator 中使用内置策略

- 可传入策略 **ID 字符串**（如 `'dma'`、`'macd'`）或 **策略类/实例**。
- 使用 **set_parameter('stg_id', pars=...)** 设置可调参数；可同时指定 ``run_freq``、``run_timing`` 以归组。

## 所有内置策略清单（罗列并简短说明）

以下为 qteasy 内置策略 ID 列表；每个策略的详细说明、参数名称与含义、信号类型请调用 **qt.built_in_doc('id')** 查看。

| 策略 ID | 类别/说明 |
|---------|-----------|
| crossline | 均线交叉类 |
| macd, macdext | MACD 相关 |
| dma, trix | 双/多均线类 |
| cdl, bband, s-bband, sarext | K 线、布林、SAR 等 |
| ssma, sdema, sema, sht, skama, smama, st3, stema, strima, swma | 平滑类（SCR 前缀） |
| dsma, ddema, dema, dkama, dmama, dt3, dtema, dtrima, dwma | 平滑类（DCR 前缀） |
| slsma, sldema, slema, slht, slkama, slmama, slt3, sltema, sltrima, slwma | 平滑类（SLP 前缀） |
| adx, apo, aroon, aroonosc, cci, cmo, mfi, di, dm, mom, ppo, rsi, stoch, stochf, stochrsi, ultosc, willr | 技术指标类 |
| ad, adosc, obv | 量能类 |
| signal_none, sellrate, buyrate | 信号控制/比例类 |
| long, short, zero | 择时固定仓位 |
| all, select_none, random | 选股类（全选/不选/随机） |
| finance, ndaylast, ndayavg, ndayrate, ndaychg, ndayvol | 选股因子类 |

完整 ID 以 **qt.built_in_list()** 返回为准；参数与用法以 **qt.built_in_doc('id')** 为准。